home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 12 / Mac Magazin and MacEasy Magazine CD - Issue 12.iso / Sharewarebibliothek / DFÜ / Internet / NetRPG ƒ / NetRPG Docs 2.2 / NetRPG Docs 2.2.rsrc / TEXT_130.txt < prev    next >
Text File  |  1995-06-20  |  20KB  |  482 lines

  1.  
  2. Chat Documentation
  3.  
  4. This is the original documentation for chat 2.06.  It's not very easy to read, so I would suggest skimming over it and then looking at it later if you need to.
  5.  
  6. ____________________________________________________
  7.  
  8.  
  9. This is a the documentation for Chat - an TCP/IP Chat Server for the Mac.
  10. It was originally written by Peter N. Lewis. Extensive modifications by me
  11. have turned it into version 2.
  12.  
  13. If anyone would like to write some better documentation for Chat 2.0 -
  14. please do so and send it to me - I just do not have the time to do it.
  15.  
  16. Email any comments/suggestions/complaints/etc. to:  nneul@umr.edu
  17.  
  18. This software is shareware - if you want to distribute it on any commercial
  19. medium (information services, CD, etc.) contact me first - I would 
  20. appreciate a sample copy of the CD for example.
  21.  
  22. The latest version of Chat and it source are available on my ftp site:
  23. pluto.cc.umr.edu   in    /pub/chat-20x
  24.  
  25. I would appreciate a note from anyone who has done anything interesting 
  26. with the source - and before anyone redistributes any derivative works. 
  27. Also, please let me know if you are using the Chat room for something - 
  28. I'd like to know it's worth it.
  29.  
  30. Enjoy...
  31.  
  32. -- Nathan Neulinger (nneul@umr.edu)
  33.  
  34. **** WHATS NEW IN 2.0.6 ****
  35.  
  36. The user password bug has been fixed. 
  37.  
  38. A new option has been added to allow the chat room application to beep 
  39. whenever someone connects.
  40.  
  41. Adminstrative variables have been added to allow administrative setting 
  42. of beep on login, prompt for channel at login, and subject. They are 
  43. BEEP, PROMPT, and SUBJECT, respectively.
  44.  
  45. A new menu option, though currently not implemented, has been added which 
  46. will allow the administrator to control whether users can change the 
  47. subject of the channel. 
  48.  
  49. The help text has been updated to reflect the change in the /CHANNEL 
  50. command, which (as of v.2.0.5) lists the channels and subjects if no channel 
  51. is specified.
  52.  
  53. **** WHATS NEW IN 2.0.5 ****
  54.  
  55. The bug that caused the username to not be displayed in the "User has 
  56. left chat room" message has been fixed.
  57.  
  58. The icon mask has been fixed, it used to not be easy to click, only a 
  59. small area of it was sensitive.
  60.  
  61. A new user variable is available "SUBJECT", allows the user to set the 
  62. subject of a channel.
  63.  
  64. The "/CHANNEL" command will now display a list of channels, and the 
  65. subjects for those channels, when a channel name is not entered. It also 
  66. puts a * in front of the channel you are currently on.
  67.  
  68. There is a new STR# resource that holds the default subjects for the 
  69. channels in the chat room.
  70.  
  71. A new preferences option and menu item is available - Prompt For Channel 
  72. At Login. If this is turned off (the default now), the user will be 
  73. automatically placed in the first channel. 
  74.  
  75. The login screens will now allow up to three chances to type in the 
  76. correct/valid response. You now will not be immediately logged out if you 
  77. make a typo in the channel name.
  78.  
  79. **** WHATS NEW IN 2.0.4 ****
  80.  
  81. Several bugs have been fixed including the infamous port 1420 problem. 
  82. Also, a beep has been added that is sounded when you receive a page.
  83.  
  84. The About box has been changed. 
  85.  
  86. Chat is now distributed by default with log files for all channels turned 
  87. off, this can be easily changed by filling in file names.
  88.  
  89. The default port is now set to 23, so you can simply telnet to the 
  90. machine chat is running on, without specifying a port number.
  91.  
  92. The problem with Chat not quitting when you shut down or restart has been 
  93. fixed. For you programmer types out there - let this be a lesson to you: 
  94. "Never name the Quit item in your file menu anything other than 'Quit' - it 
  95. was 'Quit Chat Room'".
  96.  
  97. **** WHATS NEW IN 2.0.3 ****
  98.  
  99. You can now switch between Foreground Only and Background Only versions 
  100. of the Chat Room by simply changing the Background only bit in the size
  101. resource. Thanks to Peter Lewis for providing the code to make this 
  102. possible. To cut down on size, the Chat room will be distributed in the 
  103. foreground only mode.
  104.  
  105. The utilities menu has been enabled. Features available in utilities menu:
  106.     Disabling User Passwords
  107.     Disabling Logins
  108.     Disabling Whispers
  109.     Disabling Yells
  110.     
  111. Default settings for these options are read in from the 'CPrf' resource 
  112. in the application. A 'TMPL' for editing this resource is also present. 
  113. The default port has been moved from a STR resource to the preferences 
  114. resource. The setting of disabling user passwords is restricted if their 
  115. are no passwords present in the file.
  116.  
  117. A new administrator command has been added - \SET to allow setting of 
  118. those disabled options from within the chat room. For example - with the 
  119. default admin password of "admin". The command "\SET admin logins off" 
  120. will disable any new logins. Typing "\SET admin" will list the options.
  121.  
  122. A new die rolling routine has been added - allows easy selection of 
  123. different die configurations in the standard roll playing notation such as
  124. 2d20 to roll 2 twenty sided dice. 
  125.  
  126. **** WHATS NEW IN 2.0.2 ****
  127.  
  128. By popular demand -  I have reverted to Chat being a BackGround only 
  129. application. However, instead of it only being background only, you have
  130. the choice. Two applications are distributed with the archive. The (BG) one
  131. is Background Only. The (FG) is Foreground Only. 
  132.  
  133. The only difference between the two is the "Only Background" bit in the 
  134. SIZE resource, and the 0 or 1 value in Str #3 in the Globals string
  135. resource. I know it is a cheap way to program it, but I don't have all 
  136. that much time to work on it. If anyone would like to write me a small 
  137. little piece of Pascal code that would check to see what the Background
  138. Only bit is, please do.
  139.  
  140. Plans for 2.0.3 - someone sent me some new code for the die rolling 
  141. routines. Will put that in as soon as I have a chance to rewrite it to 
  142. match the style of the rest of the program. Thanks to Erich at UIUC
  143. for the new code. 
  144.  
  145. Other Concerns: Chat logs can be placed in a specific location by 
  146. typing the full path in the ChannelLogNames string resource. 
  147. Eg. "HD 80:Chat Logs:Channel 1 Log" for example. Without the quotes! :)
  148.  
  149. There is still a problem with Chat crashing after running for an extended 
  150. time. So far - this appears to only affect Chat - it doesn't seem to bother
  151. any other programs that are running.
  152.  
  153. Chat has been successfully tested and run under A/UX 3.0.1. 
  154.  
  155. **** WHATS NEW IN 2.0.1 ****
  156.  
  157. Added the capability for leaving the user passwords string resource
  158. empty. Now, if there is nothing in the user passwords string resource
  159. the chat room will not ask for a user password on login.
  160.  
  161. Also fixed a small bug - well, didn't actually fix it, just turned off
  162. Pascal Range Checking in the compile. Problem caused Chat to crash on
  163. any machine not running MacsBug. 
  164.  
  165. **** WHATS NEW IN 2.0 ****
  166.  
  167. This is a new and improved version of Peter N. Lewis's Chat 1.1 
  168. Macintosh TCP/IP Chat Server. It now supports changing of channels,
  169. changing of user names, and many other nifty features. To customize
  170. it you will need to use ResEdit - most of the program's strings are 
  171. contained
  172. in resources so it can be customized rather extensively.
  173.  
  174. New Commands:
  175.  User Help                               /HELP
  176.  Changing channel                        /CHANNEL ch-name
  177.  Whispering to another user              /WHISPER user
  178.  Yelling to all channels                 /YELL msg
  179.  Change your name                        /SET NAME newname
  180.  Page a user to your channel             /PAGE user
  181.  List users on all channels              /LISTALL
  182.  List users on current channel only      /LIST
  183.  Rolling dice (for games I suppose)      /DICE count
  184.  
  185.  Hiding from other users (Admin Only)    \HIDE admin-pswd
  186.  Unhideing from other users (Admin Only) \UNHIDE admin-pswd
  187.  Disconnect A User (Admin Only)          \KILL admin-pswd user
  188.  Disconnect All (Admin Only)             \RESTART admin-pswd
  189.  Administrator Help                      \HELP
  190.  User and Administrator Passwords
  191.  
  192.  
  193. The default TCP port to connect to: 1420
  194. The default user password for Chat 2.0 is "permission".
  195. The default admin password for Chat 2.0 is "admin".
  196.  
  197. A sample telnet session to the chat server is enclosed.
  198.  
  199. *************************************************************************
  200. The following is the documentation enclosed w/ Chat 1.1.0. 
  201. *************************************************************************
  202.  
  203. Chat 1.1.0 ¬© Peter N Lewis, Mar 1992.
  204. This program is free, but I retain the copyright on it.
  205.  
  206. This program was initially written to assist in the online meetings of the 
  207. TopSoft group, a group of mac programmers on the Internet, dedicated to 
  208. producing free, high quality software and sample code.  To get more 
  209. information about this group, ftp to syrinx.kgs.ukans.edu and check out 
  210. the /topsoft directory, or send some mail to 
  211. ts-request@syrinx.kgs.ukans.edu and ask to be added to the mailing list.
  212.  
  213. ‚Ä¢ Contents
  214.  
  215.       What Chat Does
  216.       Using Chat
  217.       Customising Chat
  218.       How It Works
  219.       Limitations
  220.       Small Print
  221.       Warranty
  222.       Fine Print
  223.       Version History
  224.       The Author
  225.  
  226. ‚Ä¢ What Chat Does
  227.  
  228. Chat is a background only application that lets Macs with MacTCP 1.1 serve 
  229. as a very primitive IRC.  Once Chat is running on your mac, multiple 
  230. people can Telnet to port 1420 on your mac and have online discussions .  
  231. Chat has no macintosh user interface, the only way to use it is by 
  232. telneting to your mac.  I wrote this to hold the weekly online meetings of 
  233. the TopSoft group, which have proved very successful.   Chat can support 
  234. upwards of 12 users with the current memory partition (200k), and can 
  235. support an arbitrarily large number of users given enough memory (though 
  236. MacTCP will probably blow up if you try too many :-).  Add about 5 or 10k 
  237. for each extra users you want.
  238.  
  239. ‚Ä¢ Using Chat
  240.  
  241. You must have MacTCP 1.1 installed in order to use Chat.
  242.  
  243. Put Chat or an alias to it in the Startup Folder (System 7) or make it a 
  244. startup application (System 6 - note you will have to use "Selected 
  245. Applications and DAs" since background only applications are not counted 
  246. as Open Applications under System 6).  Double-Click Chat to get it started 
  247. now.
  248.  
  249. Now you need to connect to Chat using NCSA/Telnet, MUDDweller, telnet on 
  250. unix or VMS machines or some other method...
  251.  
  252. NCSA/Telnet:
  253. Choose Open Connection from the File Menu, type in the name (or IP number) 
  254. of your mac, a space and then the port number (1420).
  255.  
  256. MUDDweller:
  257. Choose New, then choose TCP/IP Address from the configure menu and type in 
  258. the ip numbers of your mac (or the name for newer versions of MUDDweller), 
  259. and the port number (1420).  Hit OK, and then choose Open Connection from 
  260. the Configure menu.
  261.  
  262. Unix:
  263. telnet <macname or ip number> 1420
  264.  
  265. VMS:
  266. telnet <macname or ip number> /port=1420
  267.  
  268. When you connect, it will ask you for a channel.  Channels are defined in 
  269. a STR# resource inside chat (no, I'm not going to make a fancy UI for 
  270. editing it).  By default, there are two channels, ‚Äúnormal‚Äù and ‚Äúnolog‚Äù.  
  271. The normal channel is logged to Normal Log on your system volume.  The 
  272. nolog channel is not logged (obviously :-).  After that it will ask you 
  273. for your name.  You are now logged in, but Chat is very boring with only 
  274. one person logged in, so get someone else to log in as well, or log in 
  275. yourself several times.  From now on anything you type will be echoed to 
  276. all other users in a format like this:
  277.  
  278. I type ‚ÄúHello‚Äù, and others would see:
  279. PeterL: Hello
  280.  
  281. Here is a sample session:
  282.  
  283. **** Sample Session ****
  284. unixprompt> telnet mymac 1420
  285. Welcome to Peter's Private Party Line.
  286. Select a channel ("normal" is a good bet):normal
  287. Enter your name:PeterL
  288. Welcome.  Commands start with a  slash (/), everything else goes to the 
  289. channel.
  290. Warning: Everything said is logged and may be used against you.
  291. /LIST
  292. FredB
  293. Hi Fred, whats up?
  294. FredB: Ahh, Peter you showed up.  Nothing much, usual stuff.
  295. FredB: How's Chat coming along?
  296. FredB: How is Chat coming along?
  297. ****
  298.  
  299. Here, I typed the lines:
  300. telnet mymac 1420
  301. normal (third line)
  302. PeterL (fourth line)
  303. Hi Fred, whats up?
  304.  
  305. Try it out, you‚Äôll get the idea pretty quick.
  306.  
  307. There are several commands, they all start with a slash (/), to get a 
  308. list, just type "/<return>":
  309.  
  310. ****
  311. /
  312. Bad command.  Commands are:
  313. /QUIT - exit chat, but why would you want to leave?
  314. /LIST - display a list of people on this channel.
  315. /DO <action> - display an action like "Yourname <action>"
  316. /ME <action> - same as /DO
  317. /SET <variable> <value> - set a variable (eg /SET echo true)
  318. everything else is sent to everyone on the channel.
  319. ****
  320.  
  321. There is also a silent command which only the owner should use, QUITNOW 
  322. (case IS relevant), which closes the server down.  Don‚Äôt use this on 
  323. someone else‚Äôs server!  As the owner, you can change this command by 
  324. changing the Globals STR#, but you probably wont need to, since no one 
  325. reads the documentation anyway, they'll never find out about it :-)
  326.  
  327. There is no way to change channels once you are on, or to listen in on 
  328. more than one channel at once (except by connecting to the server more 
  329. than once of course).
  330.  
  331. ‚Ä¢ Customising Chat
  332.  
  333. You can customise Chat by using ResEdit to change the STR# resource which 
  334. contains the port number, the channel names, and log names, the Chat Log 
  335. creator, the commands, and all the strings that Chat produces.
  336.  
  337. ‚Ä¢ How It Works
  338.  
  339. Chat is a very simple program, I wrote it in about three hours, plus I've 
  340. done about a dozen more hours neatifying it, and a couple hours getting it 
  341. ready to send out.  The entire program (ignoring the TCP and other 
  342. libraries) is only a couple hundred lines, and as such should be a good 
  343. starting sample code for writing TCP applications (the pascal source code 
  344. will be sent out as with most of my programs).
  345.  
  346. All it does is listen to the TCP port specified in the STR# resource.  
  347. When it gets a new connection it starts up another listener, and deals 
  348. with the user, first getting their channel and name, and then echoing all 
  349. their messages to the other users on that channel.  It does this by 
  350. keeping a list of all currently logged on users, when a line comes in from 
  351. one user, it goes thru the list and echoes it (with the user‚Äôs name 
  352. prepended) to all other users with the same channel.
  353.  
  354. ‚Ä¢ Limitations
  355.  
  356. Chat probably require the 128k ROM and System version 6.0 or higher.  It 
  357. may well only work with a Mac IIsi (not mine)-:, and System 7.0.  It 
  358. definitely requires MacTCP v1.1 or better yet 1.1.1.
  359.  
  360. There are several caveats.  Second, in a ‚Äúcrowded room‚Äù, you may have 
  361. troubles with people all speaking at once (which is not a real problem for 
  362. users using MUDDweller, but mucks up the screens of users who connect with 
  363. other clients).  The solution we adopted was to start and end you messages 
  364. with a blank line, so people can tell when you have finished, and avoid 
  365. interrupting you once you have started.
  366.  
  367. ‚Ä¢ Small Print
  368.  
  369. This program is free, don‚Äôt bother sending me any money for this one, it 
  370. was only a days work anyway.  If you like it, send me an Email message 
  371. saying hello, or a postcard or something like that.
  372.  
  373. You may distribute Chat any way you wish as long as you don't charge for 
  374. it (reasonable download costs such as Compu$erve are ok I guess (although 
  375. who would call Compu$erve's download costs reasonable?)).  It would 
  376. probably be a good idea to keep this documentation file with the program, 
  377. but I'm hardly likely to check up on you now am I!  I don't guarantee any 
  378. support, but I always answer my Email (I'm not so good with snail-mail and 
  379. those horrible little bits of paper and such!).  If I don't answer Email 
  380. its because your message didn't get to me, or my reply bounced (so try 
  381. again, and include a valid Internet address if you can).
  382.  
  383. You MAY NOT distribute it on any magnetic media you charge for without my 
  384. express permission unless you charge less that US$3 for the disks (and no 
  385. membership costs).  I am sick and tired of seeing people selling 
  386. PD/Shareware software for ten dollars a disk without any reimbursement to 
  387. the authors.  If you are a legitimate user group, let me know and I'll 
  388. waive teh "no membership costs" restriction. 
  389.  
  390. ‚Ä¢ Warranty
  391.  
  392.       There is absolutely NO warranty, guarantee, hint, suggestion or 
  393. anything else that would lead anyone to think that Chat do anything stated 
  394. in this documentation.  It usually does not destroy data (systems, 
  395. hardware, etc), and has sometimes worked on my Mac with System 7.0.  It is 
  396. highly unlikely that it will work with older systems (pre 6.0 anyway) or 
  397. with the 64k ROM.  It might work with the other models, but I don't have 
  398. them all, so I don't know (Anyone want to give me a IIfx (or one of those 
  399. new beasts?  How did they come up with such a terrible name???) so I can 
  400. check for compatibility?).  It might work with future versions of MacTCP 
  401. (after 1.1.1), but who can tell?  If it works on your system (or 
  402. especially if it doesn't!), send me a postcard or some Email and let me 
  403. know!
  404.  
  405. ‚Ä¢ Fine Print
  406.  
  407.       Peter Lewis hereby disclaims all warranties relating to this 
  408. software, whether express or implied, including without limitation any 
  409. implied warranties of merchantability or fitness for a particular 
  410. purpose.  Does any one really read this stuff.  Peter Lewis will not be 
  411. liable for any special, incidental, consequential, indirect or similar 
  412. damages due to loss of data or any other reason, even if Peter Lewis or an 
  413. agent of his has been advised of the possibility of such damages.  In no 
  414. event shall Peter Lewis be liable for any damages, regardless of the form 
  415. of the claim.  The person using the software bears all risk as to the 
  416. quality and performance of the software.
  417.  
  418. ‚Ä¢ Version History
  419.  
  420. Still to do -
  421.  
  422. Perhaps a password facility.
  423. Private message facility - nope, I've decided not to do this.
  424. Uniteruptable messages
  425. Log play back
  426.  
  427. v1.1.0
  428. ~Multiple channels
  429. ~New / command structure
  430.  
  431. v1.0.1
  432. ~Word wrapping lines.
  433.  
  434. v1.0.0
  435. ~Moved strings into resource fork.
  436. ~Improved strings
  437.  
  438. *****
  439. * The Author
  440.  
  441. Programs written by me:
  442. Anarchie 1.1.0 - Macintosh Archie client and FTP browser.
  443. Morpion 1.0.0 - A simple solitaire game.
  444. FTPd 2.2.0 - Macintosh FTP server.
  445. Daemon 1.0.0 - Macintosh multi-protocol daemon.
  446. Script Daemon 1.0.0 - Telnet->AppleScript gateway
  447. DeHQX 2.0.1 - BinHex decoder (use StuffIt Expander instead).
  448. Finger 1.3.7 - Macintosh Finger client/daemon.
  449. Talk 1.1.1 - Macintosh Talk client/daemon.
  450. MacTCP Watcher 1.1.0 - Display MacTCP state information.
  451. MacBinary II+ 1.0.2 - MacBinary II+ encoder/decoder.
  452. ObiWan 4.0.1 - Online help system.
  453. Bolo Finder 1.0.2 - Display the results from Mike Ellis' Bolo Tracker.
  454. Bolo RandomMap 1.1.0 - Generate a random map for Bolo.
  455. FetchNews 1.0.0b - Fetch News for use with NewsWatcher demo mode.
  456. Chat 1.1.0 - Multiuser primitive irc-like daemon.
  457.  
  458. The latest versions of my programs are available from:
  459. amug.org:/pub/ftp1/peterlewis
  460. redback.cs.uwa.edu.au:/others/peterlewis
  461. and French versions of some of my programs may be available from:
  462. ftp.sri.ucl.ac.be:/pub.
  463.  
  464. You can sometimes get the latest development versions from redback, but
  465. only use the development versions if you have some specific problem - in
  466. which case you should tell me, especially since the development versions on
  467. redback are often not the latest versions I have)
  468.  
  469. Send postcards, comments, bug reports, wishes, and payments to:
  470.  
  471. Peter Lewis,
  472. 10 Earlston Way,
  473. Booragoon, Perth, WA, 6154,
  474. AUSTRALIA
  475.  
  476. or by electronic mail to:
  477.  
  478. Internet: peter.lewis@info.curtin.edu.au
  479. Bitnet: peter.lewis%info.curtin.edu.au@cunyvm.bitnet
  480. UUCP: uunet!munnari.oz!info.curtin.edu.au!peter.lewis
  481. *****
  482.